Перейти к основному содержимому

Загрузка пользователей

Загрузка пользователей через текстовый файл​

Данный метод предоставляет множество вариантов загрузки информации (полей, связанных с пользователем): от записи пользователей на несколько курсов с назначением Ролей до обновления данных в Профиле или удаления пользователей с сайта.

Совет: Как правило, массовая загрузка пользователей через функцию "Загрузка пользователей" не требуется. Чтобы сократить объем рутинных работ, рекомендуется сначала рассмотреть методы аутентификации, не требующие ручного обслуживания. Например:

Подробнее см. раздел Аутентификация.

Ссылка на видео: Как массово загружать пользователей и добавлять на курсы.

Форматы файлов для загрузки пользователей​

Файл с данными пользователей содержит поля, разделенные ТОЛЬКО запятой (или другим разделителем) — без пробелов. Первая строка включает корректные названия полей. Остальные строки (записи) содержат информацию о каждом пользователе.

Совет: Избегайте специальных символов в данных полей, таких как кавычки или дополнительные запятые. Протестируйте файл с одной записью перед массовой загрузкой.

Совет: Вы можете использовать программу для работы с электронными таблицами, чтобы создать файл с необходимыми столбцами и полями. Затем сохраните файл в формате "CSV (разделитель — запятая)". Такие файлы можно открывать в простых текстовых редакторах (например, Notepad++) для проверки.

Допустимый файл для загрузки для тестирования​

В разделе "Администрирование" → "Пользователи" → "Учетные записи" → "Загрузить пользователей" доступен пример CSV-файла (example.csv), который можно скачать и адаптировать под свои нужды. Файл содержит следующие поля:

username,firstname,lastname,email  
student1,Student,One,s1@example.com  
student2,Student,Two,s2@example.com  
student3,Student,Three,s3@example.com

Дополнительные поля
Вы можете добавить дополнительные поля, как показано ниже. Обратите внимание, что курс и учебная группа (глобальные группы) должны быть созданы вручную заранее.

username,firstname,lastname,email,course1,group1,cohort1  
student1,Student,One,s1@example.com,math102,groupA,cohortZ  
student2,Student,Two,s2@example.com,math102,groupB,cohortY  
student3,Student,Three,s3@example.com,math102,groupA,cohortZ

Поля пользователя, которые могут быть включены​

Совет: Настоятельно рекомендуем сначала протестировать файл с предлагаемыми полями на одном пользователе перед первой загрузкой.

Обязательные поля​

Эти поля обязательны для идентификации пользователя:
username, firstname, lastname, email.

Проверки корректности:

  • username может содержать только строчные латинские буквы, цифры, дефис -, подчеркивание _, точку . или символ @.
  • email должен быть в формате: name@example.com.

Пароли​

Поле password является необязательным, если в настройках загрузки выбрано "Создать пароль при необходимости и отправить по email". Однако оно обязательно, если выбрано "Поле обязательно в файле".

Если поле включено, значения должны соответствовать Политике паролей сайта.

  • Чтобы принудительно изменить пароль пользователя, укажите в поле changeme.
  • Если поле пропущено, пароль будет сгенерирован автоматически (во время следующего запуска Cron), и пользователям отправятся приветственные письма.
  • Текст письма можно настроить в разделе:
    "Администрирование" → "Язык" → "Локальные изменения языкового пакета" → идентификатор newusernewpasswordtext.

Необязательные поля пользователя​

Примечание: Запятые внутри поля должны кодироваться как &#44 — скрипт автоматически преобразует их обратно. Совет: Для логических полей (true/false) используйте 0 (ложь) и 1 (истина).

Доступные необязательные поля (значения по умолчанию можно переопределить):

institution, department, city, country, lang, auth, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, maildigest, htmleditor, autosubscribe, interests, theme

Большинство из них — это поля профиля или предпочтений, которые заполняются вручную. Некоторые требуют особых форматов:
Ключевые требования:

  • country: используйте двухбуквенный код страны в ВЕРХНЕМ РЕГИСТРЕ (например, AU, ES, GB, US).
    • Ошибки: au, es, USA вызовут ошибку в базе данных.
    • Для кода Великобритании используйте GB (не UK).
    • Список кодов: ISO Website.
  • lang: укажите двух- или четырехбуквенный код языка из пакетов YooLearn (Moodle) (например, en, es, en_us, de).
    • Настройки: "Администрирование" → "Язык" → "Языковые пакеты".
  • auth: обязательно, если сайт использует альтернативный метод аутентификации (например, LDAP).
    • Без этого поля метод по умолчанию — manual, и пользователи не смогут войти.
    • Коды методов: manual, nlogin, ldap, db, none (см. Плагины → Аутентификация).
    • Значение nologin запретит вход для новых пользователей.
  • timezone: укажите в формате Регион/Город (например, Australia/Sydney, Europe/Madrid).
    • Регистр важен: Europe/London — верно, europe/london — ошибка.

Настройки для почты и отображения:

  • maildigest: управление дайджестом писем.
    • 0 — без дайджеста, 1 — полный дайджест, 2 — дайджест с темами.
  • maildisplay: видимость email-адреса.
    • 0 — скрыть от непривилегированных пользователей,
    • 1 — виден всем,
    • 2 — виден только участникам курса.
  • emailstop: уведомления.
    • 0 — запретить, 1 — разрешить.
  • theme: тема оформления. Укажите короткое название темы (например, boost, fordson).
    • Регистр важен: boost, а не Boost.

Оригинал: https://docs.moodle.org/502/en/Upload_users